Получение информации о подразделении
Запрос позволяет получить информацию о подразделении.
Синтаксис запроса
GET https://business.taxi.yandex.ru/api/1.0/client/{идентификатор клиента}/departament/{идентификатор подразделения}
🔴 Рекомендуем использовать API 2.0. Поддержка API 1.0 в будущем будет прекращена.
Заголовки запроса:
Authorization
OAuth-токен. Процесс получения токена описан в разделе Начало работы.
Описание полей ответа
В ответе могут содержаться следующие поля:
| Поле | Описание | Формат |
|---|---|---|
_id |
Идентификатор подразделения. | Строка |
name |
Название подразделения. | Строка |
parent_id |
Идентификатор вышестоящего подразделения (null — для корневого подразделения). |
Строка |
Пример запроса
GET https://business.taxi.yandex.ru/api/1.0/client/233e...fd7/department/2f0...f34c53
...
Authorization: <OAuth-токен>
Пример ответа
Пример ответа на данный запрос выглядит следующим образом:
{
"id": "524ac5dcadf8410aa5f5217f44933970",
"name": "Московский офис",
"parent_id": null
}
Возможные коды ответа
Ответ на данный запрос может содержать следующие стандартные HTTP-коды:
200— запрос выполнен успешно.401— был передан неверный OAuth-токен.403— у клиента не хватает прав на выполнение данного запроса.404— запрашиваемая запись не найдена.